home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / ifl_c / iflFileConfig.z / iflFileConfig
Encoding:
Text File  |  1998-10-30  |  14.6 KB  |  331 lines

  1.  
  2.  
  3.  
  4. iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg((((3333))))  IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll   iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg - iflFile configuration descriptor
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      This is a base class
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <ifl/iflCdefs.h>
  16.  
  17. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      iflFileConfig describes the configuration of an iflFile; it is used with
  19.      the iiiiffffllllFFFFiiiilllleeee::::::::ccccrrrreeeeaaaatttteeee(((()))) and iiiiffffllllFFFFoooorrrrmmmmaaaatttt::::::::aaaappppppppllllyyyyDDDDeeeeffffaaaauuuullllttttssss(((()))) calls.  The image
  20.      and page size parameters are always expressed with conventional (x ==
  21.      width, y == height) orientation, regardless of the value of the
  22.      orientation parameter.
  23.  
  24. CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
  25.      CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr
  26.  
  27.           iflFileConfig* iflFileConfigCreate(const iflSize* imagedims,
  28.                                              iflDataType datatype (0),
  29.                                              iflOrder dimensionorder (0),
  30.                                              iflColorModel colormodel (0),
  31.                                              iflOrientation orientation (0),
  32.                                              iflCompression compression (0),
  33.                                              const iflSize* pagedims )
  34.           iflFileConfig* iflFileConfigFile(iflFile* file)
  35.  
  36.      GGGGeeeetttt////sssseeeetttt iiiinnnnppppuuuutttt mmmmeeeetttthhhhooooddddssss
  37.  
  38.           void iflFileConfigSetDimensions(iflFileConfig *obj, const iflSize* imagedims)
  39.           void iflFileConfigSetDataType(iflFileConfig *obj, iflDataType datatype)
  40.           void iflFileConfigSetOrder(iflFileConfig *obj, iflOrder dimensionorder)
  41.           void iflFileConfigSetColorModel(iflFileConfig *obj, iflColorModel colormodel)
  42.           void iflFileConfigSetOrientation(iflFileConfig *obj, iflOrientation orientation)
  43.           void iflFileConfigSetCompression(iflFileConfig *obj, iflCompression compression)
  44.           void iflFileConfigSetPageDimensions(iflFileConfig *obj,
  45.                                               const iflSize* pagedims)
  46.           void iflFileConfigGetDimensions(iflFileConfig *obj, iflSize* imagedims)
  47.           const iflSize& getDimensionsPtr()
  48.           void iflFileConfigGetSize(iflFileConfig *obj, iflSize* imagesize)
  49.           iflDataType iflFileConfigGetDataType(iflFileConfig *obj)
  50.           iflOrder iflFileConfigGetOrder(iflFileConfig *obj)
  51.           iflColorModel iflFileConfigGetColorModel(iflFileConfig *obj)
  52.           iflOrientation iflFileConfigGetOrientation(iflFileConfig *obj)
  53.           iflCompression iflFileConfigGetCompression(iflFileConfig *obj)
  54.           iflFileConfig* getPageDimensionsPtr()
  55.           void iflFileConfigGetPageDimensions(iflFileConfig *obj,
  56.                                               iflSize* pagedims)
  57.  
  58.      QQQQuuuueeeerrrryyyy mmmmeeeetttthhhhooooddddssss
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg((((3333))))  IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll   iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg((((3333))))
  71.  
  72.  
  73.  
  74.           int iflFileConfigAreDimensionsDefaulted(iflFileConfig *obj)
  75.           int iflFileConfigIsDataTypeDefaulted(iflFileConfig *obj)
  76.           int iflFileConfigIsOrderDefaulted(iflFileConfig *obj)
  77.           int iflFileConfigIsColorModelDefaulted(iflFileConfig *obj)
  78.           int iflFileConfigIsOrientationDefaulted(iflFileConfig *obj)
  79.           int iflFileConfigIsCompressionDefaulted(iflFileConfig *obj)
  80.           int iflFileConfigArePageDimensionsDefaulted(iflFileConfig *obj)
  81.  
  82.  
  83. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  84.      iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg(((())))
  85.  
  86.           iflFileConfig* iflFileConfigCreate(const iflSize* imagedims,
  87.                                              iflDataType datatype (0),
  88.                                              iflOrder dimensionorder (0),
  89.                                              iflColorModel colormodel (0),
  90.                                              iflOrientation orientation (0),
  91.                                              iflCompression compression (0),
  92.                                              const iflSize* pagedims )
  93.  
  94.  
  95.           This constructor creates a fully initialized iflFile configuration
  96.           descriptor.  Defaulted attributes can be set later with the various
  97.           set methods.
  98.  
  99.      aaaarrrreeeeDDDDiiiimmmmeeeennnnssssiiiioooonnnnssssDDDDeeeeffffaaaauuuulllltttteeeedddd(((())))
  100.  
  101.           int iflFileConfigAreDimensionsDefaulted(iflFileConfig *obj)
  102.  
  103.  
  104.           This method returns true if any of the image dimensions have been
  105.           defaulted.
  106.  
  107.      aaaarrrreeeePPPPaaaaggggeeeeDDDDiiiimmmmeeeennnnssssiiiioooonnnnssssDDDDeeeeffffaaaauuuulllltttteeeedddd(((())))
  108.  
  109.           int iflFileConfigArePageDimensionsDefaulted(iflFileConfig *obj)
  110.  
  111.  
  112.           This method returns true if any of the page dimensions have been
  113.           defaulted.
  114.  
  115.      ggggeeeettttCCCCoooolllloooorrrrMMMMooooddddeeeellll(((())))
  116.  
  117.           iflColorModel iflFileConfigGetColorModel(iflFileConfig *obj)
  118.  
  119.  
  120.           This method returns the value of the color model parameter.
  121.  
  122.      ggggeeeettttCCCCoooommmmpppprrrreeeessssssssiiiioooonnnn(((())))
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg((((3333))))  IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll   iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg((((3333))))
  137.  
  138.  
  139.  
  140.           iflCompression iflFileConfigGetCompression(iflFileConfig *obj)
  141.  
  142.  
  143.           This method returns the value of the compression parameter.
  144.  
  145.      ggggeeeettttDDDDaaaattttaaaaTTTTyyyyppppeeee(((())))
  146.  
  147.           iflDataType iflFileConfigGetDataType(iflFileConfig *obj)
  148.  
  149.  
  150.           This method returns the value of the data type parameter.
  151.  
  152.      ggggeeeettttDDDDiiiimmmmeeeennnnssssiiiioooonnnnssss(((())))
  153.  
  154.           void iflFileConfigGetDimensions(iflFileConfig *obj, iflSize* imagedims)
  155.  
  156.  
  157.           This method returns the value of the image dimensions parameter.
  158.  
  159.      ggggeeeettttOOOOrrrrddddeeeerrrr(((())))
  160.  
  161.           iflOrder iflFileConfigGetOrder(iflFileConfig *obj)
  162.  
  163.  
  164.           This method returns the value of the dimension order parameter.
  165.  
  166.      ggggeeeettttOOOOrrrriiiieeeennnnttttaaaattttiiiioooonnnn(((())))
  167.  
  168.           iflOrientation iflFileConfigGetOrientation(iflFileConfig *obj)
  169.  
  170.  
  171.           This method returns the value of the orientation parameter.
  172.  
  173.      ggggeeeettttPPPPaaaaggggeeeeDDDDiiiimmmmeeeennnnssssiiiioooonnnnssss(((())))
  174.  
  175.           void iflFileConfigGetPageDimensions(iflFileConfig *obj,
  176.                                               iflSize* pagedims)
  177.  
  178.  
  179.           This method returns the value of the page dimensions parameter.
  180.  
  181.      ggggeeeettttPPPPaaaaggggeeeeSSSSiiiizzzzeeee(((())))
  182.  
  183.           This method returns the value of the page dimensions parameter.
  184.  
  185.      ggggeeeettttSSSSiiiizzzzeeee(((())))
  186.  
  187.           void iflFileConfigGetSize(iflFileConfig *obj, iflSize* imagesize)
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg((((3333))))  IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll   iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg((((3333))))
  203.  
  204.  
  205.  
  206.           This method returns the image dimensions, transposing them if the
  207.           orientation is transposed.
  208.  
  209.      iiiissssCCCCoooolllloooorrrrMMMMooooddddeeeellllDDDDeeeeffffaaaauuuulllltttteeeedddd(((())))
  210.  
  211.           int iflFileConfigIsColorModelDefaulted(iflFileConfig *obj)
  212.  
  213.  
  214.           This method returns true if the color model parameter is defaulted.
  215.  
  216.      iiiissssCCCCoooommmmpppprrrreeeessssssssiiiioooonnnnDDDDeeeeffffaaaauuuulllltttteeeedddd(((())))
  217.  
  218.           int iflFileConfigIsCompressionDefaulted(iflFileConfig *obj)
  219.  
  220.  
  221.           This method returns true if the compression parameter is defaulted.
  222.  
  223.      iiiissssDDDDaaaattttaaaaTTTTyyyyppppeeeeDDDDeeeeffffaaaauuuulllltttteeeedddd(((())))
  224.  
  225.           int iflFileConfigIsDataTypeDefaulted(iflFileConfig *obj)
  226.  
  227.  
  228.           This method returns true if the data type parameter is defaulted.
  229.  
  230.      iiiissssOOOOrrrrddddeeeerrrrDDDDeeeeffffaaaauuuulllltttteeeedddd(((())))
  231.  
  232.           int iflFileConfigIsOrderDefaulted(iflFileConfig *obj)
  233.  
  234.  
  235.           This method returns true if the dimension order parameter is
  236.           defaulted.
  237.  
  238.      iiiissssOOOOrrrriiiieeeennnnttttaaaattttiiiioooonnnnDDDDeeeeffffaaaauuuulllltttteeeedddd(((())))
  239.  
  240.           int iflFileConfigIsOrientationDefaulted(iflFileConfig *obj)
  241.  
  242.  
  243.           This method returns true if the orientation parameter is defaulted.
  244.  
  245.      sssseeeettttCCCCoooolllloooorrrrMMMMooooddddeeeellll(((())))
  246.  
  247.           void iflFileConfigSetColorModel(iflFileConfig *obj, iflColorModel colormodel)
  248.  
  249.  
  250.           This method sets the value of the color model parameter to
  251.           _c_o_l_o_r_m_o_d_e_l.
  252.  
  253.      sssseeeettttCCCCoooommmmpppprrrreeeessssssssiiiioooonnnn(((())))
  254.  
  255.           void iflFileConfigSetCompression(iflFileConfig *obj, iflCompression compression)
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg((((3333))))  IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll   iiiiffffllllFFFFiiiilllleeeeCCCCoooonnnnffffiiiigggg((((3333))))
  269.  
  270.  
  271.  
  272.           This method sets the value of the compression parameter to
  273.           _c_o_m_p_r_e_s_s_i_o_n.
  274.  
  275.      sssseeeettttDDDDaaaattttaaaaTTTTyyyyppppeeee(((())))
  276.  
  277.           void iflFileConfigSetDataType(iflFileConfig *obj, iflDataType datatype)
  278.  
  279.  
  280.           This method sets the value of the data type parameter to _d_a_t_a_t_y_p_e.
  281.  
  282.      sssseeeettttDDDDiiiimmmmeeeennnnssssiiiioooonnnnssss(((())))
  283.  
  284.           void iflFileConfigSetDimensions(iflFileConfig *obj, const iflSize* imagedims)
  285.  
  286.  
  287.           This method sets the value of the image dimension parameter to
  288.           _i_m_a_g_e_d_i_m_s.
  289.  
  290.      sssseeeettttOOOOrrrrddddeeeerrrr(((())))
  291.  
  292.           void iflFileConfigSetOrder(iflFileConfig *obj, iflOrder dimensionorder)
  293.  
  294.  
  295.           This method sets the value of the dimension order parameter to
  296.           _d_i_m_e_n_s_i_o_n_o_r_d_e_r.
  297.  
  298.      sssseeeettttOOOOrrrriiiieeeennnnttttaaaattttiiiioooonnnn(((())))
  299.  
  300.           void iflFileConfigSetOrientation(iflFileConfig *obj, iflOrientation orientation)
  301.  
  302.  
  303.           This method sets the value of the orientation parameter to
  304.           _o_r_i_e_n_t_a_t_i_o_n.
  305.  
  306.      sssseeeettttPPPPaaaaggggeeeeDDDDiiiimmmmeeeennnnssssiiiioooonnnnssss(((())))
  307.  
  308.           void iflFileConfigSetPageDimensions(iflFileConfig *obj,
  309.                                               const iflSize* pagedims)
  310.  
  311.  
  312.           This method sets the value of the page dimension parameter to
  313.           _p_a_g_e_d_i_m_s.
  314.  
  315. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  316.      iflFile(3), iflFormat(3)
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.